home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / dd.man < prev    next >
Encoding:
Text File  |  1989-04-22  |  4.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DD                        User Commands                        DD
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      dd - convert and copy a file
  10.  
  11. SSYYNNOOPPSSIISS
  12.      dddd [option=value] ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _D_d copies the specified input file to the specified output
  16.      with possible conversions.  The standard input and output
  17.      are used by default.  The input and output block size may be
  18.      specified to take advantage of raw physical I/O.
  19.  
  20.      _o_p_t_i_o_n         _v_a_l_u_e_s
  21.      if=            input file name; standard input is default
  22.      of=            output file name; standard output is default
  23.      ibs=_n          input block size _n bytes (default 512)
  24.      obs=_n          output block size (default 512)
  25.      bs=_n           set both input and output block size,
  26.                     superseding _i_b_s and _o_b_s; also, if no conver-
  27.                     sion is specified, it is particularly effi-
  28.                     cient since no copy need be done
  29.      cbs=_n          conversion buffer size
  30.      skip=_n         skip _n input records before starting copy
  31.      files=_n        copy _n input files before terminating (makes
  32.                     sense only where input is a magtape or simi-
  33.                     lar device).
  34.      seek=_n         seek _n records from beginning of output file
  35.                     before copying
  36.      count=_n        copy only _n input records
  37.      conv=ascii     convert EBCDIC to ASCII
  38.           ebcdic    convert ASCII to EBCDIC
  39.           ibm       slightly different map of ASCII to EBCDIC
  40.           block     convert variable length records to fixed
  41.                     length
  42.           unblock   convert fixed length records to variable
  43.                     length
  44.           lcase     map alphabetics to lower case
  45.           ucase     map alphabetics to upper case
  46.           swab      swap every pair of bytes
  47.           noerror   do not stop processing on an error
  48.           sync      pad every input record to _i_b_s
  49.           ... , ... several comma-separated conversions
  50.  
  51.      Where sizes are specified, a number of bytes is expected.  A
  52.      number may end with kk,, bb or ww to specify multiplication by
  53.      1024, 512, or 2 respectively; a pair of numbers may be
  54.      separated by xx to indicate a product.
  55.  
  56.      _C_b_s is used only if _a_s_c_i_i, _u_n_b_l_o_c_k, _e_b_c_d_i_c, _i_b_m, or _b_l_o_c_k
  57.      conversion is specified.  In the first two cases, _c_b_s char-
  58.      acters are placed into the conversion buffer, any specified
  59.      character mapping is done, trailing blanks trimmed and new-
  60.  
  61.  
  62.  
  63. Sprite v1.0              April 29, 1985                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DD                        User Commands                        DD
  71.  
  72.  
  73.  
  74.      line added before sending the line to the output.  In the
  75.      latter three cases, characters are read into the conversion
  76.      buffer, and blanks added to make up an output record of size
  77.      _c_b_s.
  78.  
  79.      After completion, _d_d reports the number of whole and partial
  80.      input and output blocks.
  81.  
  82.      For example, to read an EBCDIC tape blocked ten 80-byte
  83.      EBCDIC card images per record into the ASCII file _x:
  84.  
  85.  
  86.           dd if=/dev/rmt0 of=x ibs=800 cbs=80 conv=ascii,lcase
  87.  
  88.      Note the use of raw magtape.  _D_d is especially suited to I/O
  89.      on the raw physical devices because it allows reading and
  90.      writing in arbitrary record sizes.
  91.  
  92. SSEEEE AALLSSOO
  93.      cp(1), tr(1)
  94.  
  95. DDIIAAGGNNOOSSTTIICCSS
  96.      f+p records in(out): numbers of full and partial records
  97.      read(written)
  98.  
  99. BBUUGGSS
  100.      The ASCII/EBCDIC conversion tables are taken from the 256
  101.      character standard in the CACM Nov, 1968.  The `ibm' conver-
  102.      sion, while less blessed as a standard, corresponds better
  103.      to certain IBM print train conventions.  There is no univer-
  104.      sal solution.
  105.      One must specify ``conv=noerror,sync'' when copying raw
  106.      disks with bad sectors to insure _d_d stays synchronized.
  107.  
  108.      Certain combinations of arguments to _c_o_n_v= are permitted.
  109.      However, the _b_l_o_c_k or _u_n_b_l_o_c_k option cannot be combined with
  110.      _a_s_c_i_i, _e_b_c_d_i_c or _i_b_m.  Invalid combinations _s_i_l_e_n_t_l_y _i_g_n_o_r_e
  111.      all but the last mutually-exclusive keyword.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              April 29, 1985                         2
  130.  
  131.  
  132.  
  133.